═══ 1. Copyright Information ═══ Copyright (c) BonAmi Software Corporation, 1991-1993. All rights reserved. For all product information, please contact: BonAmi Software Corporation 60 Thoreau Street, Suite 219 Concord, Massachusetts 01742 U.S.A. Telephone: (508) 371-1997 ═══ 2. Contacting BonAmi ═══ For all product information, please contact: BonAmi Software Corporation 60 Thoreau Street, Suite 219 Concord, Massachusetts 01742 U.S.A. Telephone: (508) 371-1997 ═══ 3. Help for Help ═══ Most of the menu items have help available. Select Extended Help for an overview of CPU Monitor Plus. Select Keys Help for a description of the special key assignments and combinations used by CPU Monitor Plus. ═══ 4. Keys Help ═══ The special keys and key-combinations usable in CPU Monitor Plus are: F1 Display context sensitive help; Shift-F3 Save current selections and preferences; Ctrl-0 Display the percent CPU time used by each process; Ctrl-1 Display all processes; Ctrl-2 Display the percent CPU idle time; Ctrl-3 Display all process threads; Ctrl-4 Display private RAM and CPU utilization values for all processes. Ctrl-C Modify system defaults and configuration; Ctrl-D Disable the timed display; Ctrl-E Enable the timed display; Ctrl-F Display specific process data fields; Ctrl-K Kill a specified process; Ctrl-L Log output to a file; Ctrl-N Update the display now! Ctrl-O Modify how the display is ordered; Ctrl-P Change a thread's priority; Ctrl-R Display specific RAM data fields; Ctrl-S Select specific processes and threads to display; Ctrl-T Start a specified program; Ctrl-U Suspend a specified thread; Ctrl-V Select the custom view display. Ctrl+Insert Copy the display to the clipboard ═══ 5. About CPU Monitor Plus ═══ Use CPU Monitor Plus to monitor and control the programs executing on your computer. CPU Monitor Plus provides you with facilities to: o Start and stop programs under your control; o Change the execution priority and state for a process or its threads; o Continuously monitor the CPU and RAM usage for processes and threads. Under OS/2, a program, its data, and its threads of execution are collectively called a process. A process is created when a program is loaded into memory by the OS/2 system loader (part of the OS/2 kernel). Threads in a process run independently, each with their own stack and execution privileges. OS/2 is multitasking in that threads from multiple processes all compete for and share the computer's CPU, memory, and device resources. CPU Monitor Plus allows you to closely examine and control the operation of OS/2. You select the data that you want to monitor and how you want that data displayed. Use the File pull-down menu to: o Log CPU Monitor Plus output to a file; o Save or reset current display selections and preferences; o UnInstall CPU Monitor Plus; Use the Edit pull-down menu to copy the current CPU Monitor Plus display to the clipboard. The Commands pull-down menu allows you to: o Start a new process from CPU Monitor Plus; o Stop a currently executing process; o Change the execution priority of individual threads within a process; o Suspend a currently executing thread; o Instantaneously examine the current CPU Utilization data. Use the View pull-down menu to: o Select specific processes and threads to display; o Fully customize the CPU Monitor Plus display; o Choose from several useful predefined displays. Use the Options pull-down menu to customize, enable, and disable the display. Also use this to set the statistics gathering parameters. Additional help is available for all menu choices. To quit CPU Monitor Plus, select Close from the System Menu or the Window/Task list. ═══ 6. File Menu Help ═══ Commands available from the File menu are: o Log output to a file; o Save current display options; o Reset selectable display options; o UnInstall CPU Monitor Plus from OS/2; ═══ 6.1. Log File ═══ Use this to change the file logging status. Select a file for file logging, or disable file logging. When logging is enabled and a log file has been selected, CPU Monitor Plus copies the displayed system data to the log file. The rate at which new data is appended to the log file is determined by the display frequency setting. New data is appended each time the screen is updated. The display frequency rate may be modified via the Configure dialog. Note: Data may be logged to at most one file at a time. File logging can also be automatically enabled when CPU Monitor Plus starts via a command line switch. See the CPU Monitor Plus User's Guide for details on using the command line switches. Log is selected from the File menu. or with the Ctrl-L hot key. ═══ 6.2. Save ═══ Use this to save the current program options and settings. When CPU Monitor Plus is next started, the saved options will automatically be restored. The options saved are the current values for: o Screen colors; o Display window dimensions; o Display number base; o Display font; o Custom display fields and ordering; o Display frequency rate; o Statistics gathering frequency; o Currently selected display. Save is selected from the File menu or with the Shift-F3 hot key. ═══ 6.3. Reset ═══ Use this to reset all user selectable settings to their factory defaults. The following settings are reset: o Screen colors; o Display font; o Custom display fields and ordering; o Display frequency rate; o Statistics gathering frequency; o Default display; o Log file and logging status; o Display Enabled; o Selected processes in customized display. o Display number base; Note: Reset does not cause any of the reset settings to be saved. The Save menu option is required to save these values. Reset is selected from the File menu. ═══ 6.4. UnInstall ═══ Select UnInstall to permanently unload CPU Monitor Plus from your system. UnInstall updates the OS2.INI file and prevents OS/2 from automatically loading the CPU Monitor Plus dynamic link libraries. UnInstall will not delete any CPU Monitor Plus files, nor will it update your CONFIG.SYS file. Any references to the CPU Monitor Plus device driver in the CONFIG.SYS file must be removed manually. The Un-Installation process will be complete once OS/2 has been shut down and restarted. Of course, CPU Monitor Plus may be reinstalled later at your convenience. For more information on the Installation and Un-Installation process, refer to the CPU Monitor Plus User's Guide. UnInstall is selected from the File menu. ═══ 7. Edit Menu Help ═══ Commands available from the Edit menu are: o Copy the CPU Monitor Plus display to the clipboard. ═══ 7.1. Copy to Clipboard ═══ Use this to copy the current CPU Monitor Plus display to the clipboard. The clipboard is used to transfer and share information between different programs. The visible portion of the CPU Monitor Plus display is copied as a bitmap image. The complete CPU Monitor Plus display, including all scrolled areas, is copied as unformatted text to the clipboard. See your OS/2 documentation for additional information on accessing and using the clipboard. ═══ 8. View Menu Help ═══ Commands available from the View menu are: o Select processes to monitor; o Set the display order criteria; o Choose the process data fields and RAM data fields to include in the display. In addition, there are five pre-defined and one custom display options. They are: o Display the percent CPU time used by each process; o Display all processes; o Display the percent CPU Idle time; o Display all threads; o Display RAM and CPU usage for each processes; o Display using the currently configured custom settings. ═══ 8.1. Select ═══ Use this to select the specific processes and threads to be displayed. Only those processes chosen will be included in the display. This option is useful to focus on certain key processes. Select is selected from the View menu or with the Ctrl-S hot key. ═══ 8.2. Ordering ═══ Use this to choose how the individual items in the display are ordered. Choose ascending or descending ordering based upon: o Percent CPU Utilization; o Process ID; o Process Name; o Process Priority; o Session ID; o Parent's Process ID. Ordering is selected from the View menu or with the Ctrl-O hot key. Related Information o Process Data Fields ═══ 8.3. Process Data Fields ═══ Use this to select specific process data fields to include in a customized display. The following information can be included: o Process Name; o Process ID; o Parent's Process ID; o Session ID; o Thread ID for each thread in the process; o Process Priority; o Process Execution State; o Percent CPU time idle; o Percent CPU time used by process or thread; o Total CPU Time used by process or thread. The customized display combines the above process data fields with any other selected RAM data fields. All field choices are preserved even after another display mode is chosen. To return to the customized display, invoke the Custom View menu item. The field selections are not automatically saved when CPU Monitor Plus is terminated. To save these choices, select the Save menu item from the File menu. Process Fields is selected from the View menu or with the Ctrl-F hot key. Related Information o RAM Data Fields o View Menu Item ═══ 8.4. RAM Data Fields ═══ Use this to select the specific RAM data fields to include in the display. The following information can be included: o Private In-Use RAM; o Private Allocated RAM; o Shared In-Use RAM; o Shared Allocated RAM; o Total In-Use RAM; o Total Allocated RAM; o RAM use ratios. The RAM data field choices are combined with the process data field choices in the custom display. the All field choices are preserved even after a pre-defined display mode is chosen. To return to the selected field choices, invoke the Custom View menu item. The field choices are not automatically saved when CPU Monitor Plus is terminated. To save these choices, select the Save menu item from the File menu. RAM Data Fields is selected from the View menu or with the Ctrl-R hot key. Related Information o Process Data Fields o View Menu Item ═══ 8.5. CPU Time View ═══ Use this predefined display to view the Percent CPU time used by each process in decreasing order. CPU Time View is selected from the View menu or with the Ctrl-0 hot key. ═══ 8.6. Process ID's View ═══ Use this predefined display to view information for all processes in Process ID order. Process ID's View is selected from the View menu or with the Ctrl-1 hot key. ═══ 8.7. Idle Time View ═══ Use this predefined display to view the Percent CPU time idle. Idle View is selected from the View menu or with the Ctrl-2 hot key. ═══ 8.8. Threads View ═══ Use this predefined display to view information for all threads in Process and Thread ID order. Threads View is selected from the View menu or with the Ctrl-3 hot key. ═══ 8.9. RAM & CPU Usage View ═══ Use this predefined display to view the percent CPU time along with the private allocated and private in-use RAM usage for each process. The memory totals are displayed as either decimal or hexadecimal numbers, according to the current number base selection. RAM & CPU Usage View is selected from the View or with menu the Ctrl-4 hot key. Related Information o CPU Monitor Plus configuration ═══ 8.10. Custom View ═══ Use this to select a customized display as specified by the Select, Process Data Fields, RAM Data Fields and Order dialogs. Custom View is selected from the View menu or with the Ctrl-V hot key. Related Information o Select processes o Process data fields o RAM data fields o Display ordering ═══ 9. Commands Menu Help ═══ Commands available from the Commands menu are: o Update the display now! o Kill a specified process; o Change a thread's priority; o Suspend a currently executing thread; o Start a specified program. ═══ 9.1. Update Now! ═══ Use this to force an update of the latest statistics data to the screen. Update Now! will also update the log file if File Logging is enabled. Update Now! is selected from the Commands menu or with the Ctrl-N hot key. Related Information o Display frequency; ═══ 9.2. Kill ═══ Use this to terminate a selected process. Note that programs may take preventive action to prevent being terminated. Also, in some cases a selected process cannot be terminated. When this occurs, a warning message will be displayed. Kill is selected from the Commands menu or with the Ctrl-K hot key. ═══ 9.3. Priority ═══ Use this to examine or change the execution priority of a process. Only those threads and processes belonging to most Presentation Manager application programs can have their priority changed. Note that CPU Monitor Plus can also change its own execution priority if requested. Priority is selected from the Commands menu or with the Ctrl-P hot key. ═══ 9.4. Start ═══ Use this to start a program from CPU Monitor Plus. The program executes independently from and asynchronously to CPU Monitor Plus. Only OS/2 executable programs may be started from CPU Monitor Plus. Batch files and DOS programs are not allowed. Start is selected from the Commands menu or with the Ctrl-T hot key. ═══ 9.5. Suspend ═══ Use this to suspend a currently executing thread or to restart a thread that has been suspended. Only those threads and processes belonging to most Presentation Manager application programs can be suspended and restarted. Suspend is selected from the Commands menu or with the Ctrl-U hot key. ═══ 10. Options Menu Help ═══ Commands available from the Options menu are: o Disable the timed screen update; o Enable the timed screen update; o Configure the CPU Monitor Plus display and data collection. ═══ 10.1. Configure ═══ Use this to configure the CPU Monitor Plus display and statistics collection mode. Configuration parameters include: o Display color scheme; o Number base; o Screen font; o Display frequency; o Statistics gathering frequency. Configure is selected from the Options menu or with the Ctrl-C hot key. ═══ 10.1.1. Color Scheme ═══ Use this to choose between a number of different predefined color schemes. The color scheme may be modified in the Configure dialog. Select Configure from the Options menu or with the Ctrl-C hot key. Changing the color scheme is provided by the Configure dialog. ═══ 10.1.2. Number Base Selection ═══ Use this to select either decimal (base 10) or hexadecimal (base 16) number displays. Hexadecimal values may be useful to correlate CPU Monitor Plus displays with other OS/2 system and programming information. The default is to display all numbers as decimal integers. Note: CPU Percentages are always displayed in decimal integers regardless of the specified number base. The number base may be modified in the Configure dialog. Select Configure from the Options menu or with the Ctrl-C hot key. ═══ 10.1.3. Font Selection ═══ Use this to select a different fixed-width Courier or System Monospaced font for the CPU Monitor Plus display. The display font may be modified in the Configure dialog. Select Configure from the Options menu or with the Ctrl-C hot key. ═══ 10.1.4. Statistics gathering frequency ═══ Use this to change the statistics gathering mode and frequency. There are two different modes of operation: o Statistics gathering using the CPU Monitor Plus device driver; o Statistics gathering from CPU Monitor Plus The Slow, Normal, and Fast options specify that statistical data be collected by the CPU Monitor Plus device driver at a rate of 5, 10, and 32 times per second respectively. Fast provides the highest level of accuracy for CPU utilization estimates. Slow and Normal both provide high levels of accuracy while using less CPU time to gather the data. The Alternate mode specifies that CPU Monitor Plus itself gather all statistical information. This method is less accurate than using the CPU Monitor Plus device driver, since CPU Monitor Plus runs only as a standard OS/2 application. As such, its own CPU allocation is in contention with all other applications running on the system. BonAmi Software recommends using the Slow or Normal gathering frequency for most environments. Use the Alternate mode to disables all statistics gathering by the CPU Monitor Plus device driver. Note: The Alternate mode gathers data at a rate dependent on the display frequency. In general, shorter display frequencies provide higher accuracy for the Alternate method. The display frequency rate has little effect when using one of the device driver modes. Refer to the CPU Monitor Plus User's Guide for more details on the statistics gathering options available in CPU Monitor Plus. The statistics gathering frequency may be modified in the Configure dialog. Select Configure from the Options menu or with the Ctrl-C hot key. ═══ 10.1.5. Display frequency ═══ Use this to change the display update frequency. You may select any value between 1 and 60 seconds. Note: When using the CPU Monitor Plus device driver, process statistics are gathered independently of the display frequency. Different display frequency rates will influence statistics gathered by CPU Monitor Plus only when the CPU Monitor Plus device driver is not used. Refer to the CPU Monitor Plus User's Guide for more details on the statistics gathering methods used in CPU Monitor Plus. The display frequency can be automatically set when CPU Monitor Plus starts via a command line switch. See the CPU Monitor Plus User's Guide for details on using the command line switches. The display frequency may be modified in the Configure dialog. Select Configure from the Options menu or with the Ctrl-C hot key. ═══ 10.2. Disable ═══ Use this to disable the timed display of statistics to the screen. This will also disable logging output to a file. Select the Enable menu item to restart the screen display. Disable is selected from the Options menu or with the Ctrl-D hot key. ═══ 10.3. Enable ═══ Use this to enable the timed display of statistics to the screen. By default, the display is normally enabled. If the Disable option has been invoked, Enable will restart the timed display. This will also restart logging output to a file. Enable is selected from the Options menu or with the Ctrl-E hot key. ═══ Log File Help ═══ Enter a filename where the CPU Monitor Plus data will be logged. Select: o Enable to enable data logging; o Disable will disable data logging.; o Overwrite will erase the log file if it already exists; o Append will add log data to the end of an existing file. Choose OK to confirm the above selections. Cancel will abort any changes selected. Help displays this text. If the Log File becomes unavailable or if the file is unable to accommodate additional data, an error message will be displayed. In these cases, file logging will be disabled until a new log file is selected. Note: Data may be logged to at most one file at a time. File logging can also be automatically enabled when CPU Monitor Plus starts via a command line switch. See the CPU Monitor Plus User's Guide for details on using the command line switches. ═══ Kill Process Help ═══ Select the process that is to be terminated. Press Kill to terminate or press Cancel to abort any selections. If the Confirm Kill Request Check box is checked, a confirmation request will be issued before the process is killed. De-selecting the check box eliminates confirmations. To efficiently kill a series of processes, double click on each Process Name instead of pressing the Return key or the Kill push button. Note that the list of processes is not automatically updated. Press Refresh to update the list. CPU Monitor Plus retains process information for a period of time dependent on the current display frequency. Furthermore, be aware that a process may not terminate immediately. Some processes take measures to avoid being terminated. The kill request will be sent out correctly, but the process may still ignore it and continue to execute. Related Information o CPU Monitor Plus configuration ═══ Configure Display Help ═══ Configure the CPU Monitor Plus display and statistics collection mode. The following parameters can be set: Display Frequency Enter the number of seconds to wait between screen updates. You may select any value between 1 and 60 seconds. Note: The CPU Monitor Plus device driver carries out statistics gathering independently of the display frequency. Nevertheless, the display frequency influences statistics gathering when CPU Monitor Plus itself collects the statistics without a device driver. Refer to the CPU Monitor Plus User's Guide for more details on the statistics gathering methods used in CPU Monitor Plus. The display frequency can also be automatically set when CPU Monitor Plus starts via a command line switch. See the CPU Monitor Plus User's Guide for details on using the command line switches. Statistics Gathering Frequency Enter the desired statistics gathering frequency mode. The Slow, Normal, and Fast options specify that statistical data be collected by the CPU Monitor Plus device driver at a rate of 5, 10, and 32 times per second respectively. Fast provides the highest level of accuracy for CPU utilization estimates. Slow and Normal both provide high levels of accuracy while using less CPU time to gather the data. The Alternate mode specifies that CPU Monitor Plus itself gather all statistical information. This method is less accurate than using the CPU Monitor Plus device driver, since CPU Monitor Plus runs only as a standard OS/2 application. As such, its own CPU allocation is in contention with all other applications running on the system. BonAmi Software recommends using the Slow or Normal gathering frequency for most environments. Use the Alternate mode to disables all statistics gathering by the CPU Monitor Plus device driver. Note: The Alternate mode gathers data at a rate dependent on the display frequency. In general, shorter display frequencies provide higher accuracy for the Alternate method. The display frequency rate has little effect when using one of the device driver modes. Number Base Select either decimal (base 10) or hexadecimal (base 16) number displays. Hexadecimal values may be useful to correlate CPU Monitor Plus displays with other OS/2 system and programming information. The default is to display all numbers as decimal integers. Note: CPU percentages are always displayed in decimal integers regardless of the specified number base. Font Size Use this to select a different size fixed-width Courier or System Monospaced font for the CPU Monitor Plus display. Both bold and normal attributes may not be available for all fonts in all sizes. Color Scheme Use this to choose between a number of different predefined color schemes. Save Configuration Info Check this to permanently save all configuration information when OK is pressed. The saved configuration information will be written to the OS2.INI file and used the next time CPU Monitor Plus is started. Press OK to accept the entered values. If Save Configuration Info is checked, all configuration information will be saved. Press Escape or Cancel to abort any selections. Press Default to choose the factory default settings. The Save menu option can also be used to save the current configuration settings. ═══ Exit Help ═══ Press OK to terminate CPU Monitor Plus. If the Save Current Setting check box is checked the following settings are saved: o Screen colors; o Display window dimensions; o Display number base; o display font; o Custom display fields and ordering; o Display frequency rate; o Statistics gathering frequency; o Currently selected display. Press Cancel to abort any selections and return to CPU Monitor Plus processing. ═══ Start Process Help ═══ Enter the information necessary to simulate starting a program from the command line. The Working Directory and Parameters entries are optional. If the program executes in the background, check Background Task. Press Start or double click on an entry in the Files list to start the desired program. Only OS/2 executable programs can be started. Press Reset to quickly erase any information already entered. Press Cancel to abort any selections. Note: CPU Monitor Plus can start processes automatically via a command line switch. See the CPU Monitor Plus User's Guide for details on using the command line switches. ═══ Change Priority Help ═══ Select the process whose priority is to be changed. The current Priority Class and Level are displayed for each selected thread. Since OS/2 restricts changing thread priorities in other processes, only those threads belonging to most Presentation Manager programs can have their priority changed. To change a thread's priority, press Set after selecting new Priority Class and Priority Level values. Press Cancel to abort any selections. Refresh updates the display for any processes that have recently terminated or started. Be aware that CPU Monitor Plus retains process information for a period of time dependent on the current display frequency. Related Information o CPU Monitor Plus configuration ═══ Display Process Data Fields Help ═══ Select the data fields to include in the Custom display. Each of the fields is described below. o Process ID is the unique identifier for every process. o Process Name is the name assigned to the current process. More than one program with the same name or more than one instance of the same program may be simultaneously loaded for execution; use the Process ID to distinguish between these programs. o Process Priority has a two-part value. The first digit is the priority class. OS/2 gives a task with a higher priority class preference over a lower priority class. The priority classes from lowest to highest are: - 1: Idle Priority - 2-7: Regular and Foreground Priority - 8: Time Critical Priority Each priority class has 32 levels, 0 the lowest priority and 31 the highest (0 to 1F in hexadecimal). Be aware that OS/2 normally adjusts each task's priority within a class dynamically, to insure that every task gets some CPU time. Note: The Foreground (or fixed high) priority class actually has a higher priority than the Regular class. This allows the current screen group to respond more favorably to an interactive user. o All Threads displays all the threads for each process. o State displays the execution state of a process or thread. It may be Ready if the process or thread is ready or currently executing. If the thread is not Ready, it may be Blocked or Frozen. o Session ID is the session or screen group identifier. o Parent's ID displays the parent's process identifier for each thread or process. o Total CPU Time displays the cumulative CPU time used by a process as recorded by CPU Monitor Plus. Any time used by the process when CPU Monitor Plus was not enabled is not included. CPU Utilization values are displayed as specified below: o CPU Utilization will display a bar graph or decimal number representing the percent CPU time used by the process or thread during the last display period. o Idle Time displays the estimated percentage of the time that the CPU was idle during the last display period. Numeric fields are displayed in the current number base, either decimal or hexadecimal. Percentages are always displayed in decimal. The number base is changed from the Configure dialog. Press OK to enable the display with the new field selections. Press Cancel to abort any selections. Press Default to choose the factory default settings. Related Information o Display Frequency ═══ Display RAM Data Fields Help ═══ Select the RAM information to include in the Custom display. The individual RAM Data Fields may be displayed in bytes or pages, where one page equals 4096 bytes (on 80386 and 80486 CPU's). The data fields are: o Private In Use displays the amount of Private RAM currently marked present by OS/2 for a process; o Shared In Use displays the amount of Shared RAM currently marked present by OS/2 for a process; o Total In Use displays the sum of Private and Shared RAM currently marked present by OS/2 for a process; o Private Allocated displays the amount of Private RAM currently allocated by OS/2 for a process; o Shared Allocated displays the amount of Shared RAM currently allocated by OS/2 for a process; o Total Allocated displays the sum of Private and Shared RAM currently allocated by OS/2 for a process; The Ratios Currently Selected entries are ratios of individual RAM data fields. Total Available RAM is the total amount of RAM available for OS/2 applications. Total Installed RAM is the amount of RAM installed on the computer, as reported by OS/2. Each selected ratio can be displayed as either a bar graph or a decimal percent. For the RAM Utilization Ratios press: o Add to add the current "Ratio Top / Ratio Bottom" pair to the Ratios Currently Selected list; selection. o Remove to remove the current ratio selection from the list; o Clear to remove all entries from the list. Press OK to accept all selections for the Custom display. Press Default to choose the factory default settings. Related Information o Process data fields o RAM data fields o Custom View ═══ Display Order Help ═══ Select how the display is to be ordered. The display is arranged in either ascending or descending order based on one of the following fields: o Process Name; o Process ID; o Session ID; o Parent's Process ID; o CPU Time used; o Process Priority. Press OK to select the new display order. Press Cancel to abort any selections. ═══ Select Process Help ═══ Select specific processes and threads to include in the display. Only those items selected will appear in the display. Press OK to include the selected processes in the display. Press Cancel to abort any new selections. Note: To display data for all processes, make sure that no entries in the Process List are selected. Press Reset to quickly clear any selected entries. ═══ Suspend Thread Help ═══ Select the process and thread to be suspended or resumed. If the state for a thread is displayed as 'Suspend', then that thread is currently suspended. 'Normal' indicates that the thread is not suspended. Since OS/2 places restrictions on suspending threads in other processes, only those threads belonging to most Presentation Manager programs can be suspended or resume executing. Press Refresh to update the display for any processes that have recently terminated or started. Be aware that CPU Monitor Plus retains process information for a period of time dependent on the current display frequency. Press Set to change the execution state for the selected thread. Press Cancel to return to the CPU Monitor Plus display. Warning: It may NOT be possible to resume a process whose sole 'Message Loop' thread has been suspended. In many programs, the first thread (Thread 1) has the responsibility for dispatching all messages for that process in a message loop. This thread is referred to as the message loop thread. Therefore, if you choose to suspend Thread 1 in any process, a warning will be displayed. Suspended threads may sometimes be identified by a "Frozen" entry in CPU Monitor Plus' "State" column. "State" is included in the Custom View display via the Fields menu item. Related Information o CPU Monitor Plus configuration ═══ Installation Help ═══ Use the CPU Monitor Plus Setup program to install CPU Monitor Plus in your system. Setup performs the following operations: o Initializes the CPU Monitor Plus executable file; o Copies the program files to your hard disk; o Updates the CONFIG.SYS and OS2.INI files. CPU Monitor Plus can perform some installation functions itself. These are limited to updating the OS2.INI file to automatically load the CPU Monitor Plus dynamic link libraries. This feature may be useful if you reinstall CPU Monitor Plus after having previously selected UnInstall. To allow CPU Monitor Plus to install itself, select YES when prompted to continue with the installation. CPU Monitor Plus will then backup and update the OS2.INI system file. The CONFIG.SYS file is not updated, nor are any files copied to the hard disk. After installation is complete, the computer should then be restarted to enable all CPU Monitor Plus functions. Note: Part of the installation process requires that the CPU Monitor Plus help file, dynamic link libraries, and device driver be referenced from the CONFIG.SYS file. These functions are only performed by the Setup program. Refer to the CPU Monitor Plus User's Guide for more information. To permanently unload CPU Monitor Plus from your system, select the UnInstall menu item from the File menu. The Un-Installation process will be complete after the computer has been restarted. CPU Monitor Plus may be reinstalled later at your convenience. ═══ Installation Error Help ═══ CPU Monitor Plus was unable to complete the installation process. If you press OK to continue, not all CPU Monitor Plus functions will be available. ═══ Installation Error Help ═══ CPU Monitor Plus was unable to backup the system OS2.INI file. Since CPU Monitor Plus makes changes to OS2.INI, it first makes a backup copy called OS2INI.BA. This backup file is put in the same directory where OS2.INI is found. At this point, you may still continue installing CPU Monitor Plus. However, in the very unlikely event that the OS2.INI file becomes corrupt, CPU Monitor Plus will not have created the OS2INI.BA backup. Select YES to continue with the installation process. Select NO to abort the installation. ═══ Initialization Error Help ═══ CPU Monitor Plus has not been completely installed. As a result, some CPU Monitor Plus functions may not operate correctly. Use the Setup program to best install CPU Monitor Plus. If you have previously run Setup, you may also try to install using CPU Monitor Plus. Restart CPU Monitor Plus and press 'Yes' when asked to install. Then restart OS/2 to complete the installation process. Note: Part of the installation process requires that the CPU Monitor Plus help file, dynamic link libraries, and device driver be referenced from the CONFIG.SYS file. These functions are only performed by the Setup program. Refer to the CPU Monitor Plus User's Guide for more information. ═══ Initialization Error Help ═══ CPU Monitor Plus has not been completely installed. As a result, some CPU Monitor Plus functions may not operate correctly. Use the Setup program to best install CPU Monitor Plus. If you have previously run Setup, you may also try to install using CPU Monitor Plus. Restart CPU Monitor Plus and press 'Yes' when asked to install. Then restart OS/2 to complete the installation process. Note: Part of the installation process requires that the CPU Monitor Plus help file, dynamic link libraries, and device driver be referenced from the CONFIG.SYS file. These functions are only performed by the Setup program. You may choose to do these manually as in the following example: Example: device=C:\CPUMONP\CPUMONP.SYS Refer to the CPU Monitor Plus User's Guide for more information. ═══ UnInstallation Help ═══ To permanently remove CPU Monitor Plus from your system, select YES when prompted to Un-Install. UnInstall updates the OS2.INI file to permanently remove all CPU Monitor Plus startup information. UnInstall does not update the CONFIG.SYS file. After Un-Installing, CPU Monitor Plus will be completely removed once the computer has been restarted. Note: Part of the installation process requires that the CPU Monitor Plus device driver, dynamic link libraries, and help file be referenced from the CONFIG.SYS file. These references are not removed by UnInstall. Refer to the CPU Monitor Plus User's Guide for more information. CPU Monitor Plus may be installed later at your convenience. ═══ Log File Error Help ═══ If the log file becomes unavailable or if the file is unable to accommodate additional data, an error message will be displayed. In these cases, file logging will be disabled until a new log file is selected. Note: Data may be logged to at most one file at a time. ═══ Kill Process Error Help ═══ The selected process no longer exists. Choose another process to kill or select Cancel to return to CPU Monitor Plus. Note: The list of processes in the Kill Process dialog box is not automatically updated. Press Refresh at any time to update the display for processes that have recently started or terminated. Be aware that CPU Monitor Plus retains process information for a period of time dependent on the current display frequency. ═══ Kill Process Confirmation Help ═══ The specified process is to be killed. Press OK to kill the process. Press CANCEL to abort. ═══ Change Priority Error Help ═══ CPU Monitor Plus is unable to determine the priority for the selected process. This may occur if the selected process has terminated. Choose another process or press Cancel to return to CPU Monitor Plus. Note: The list of processes in the Change Priority dialog box is not automatically updated. Press Refresh at any time to update the display for processes that have recently started or terminated. Be aware that CPU Monitor Plus retains process information for a period of time dependent on the current display frequency. ═══ Suspend Thread Error Help ═══ CPU Monitor Plus is unable to determine the execution state for the selected process and thread. This may occur if the selected process or thread has terminated. Choose another thread or press Cancel to return to CPU Monitor Plus. Note: The list of processes in the Suspend Thread dialog box is not automatically updated. Press Refresh at any time to update the display for processes and threads that have recently started or terminated. Be aware that CPU Monitor Plus retains process information for a period of time dependent on the current display frequency. ═══ Clipboard Warning Help ═══ CPU Monitor Plus was unable to completely copy the current display to the clipboard. Data at the end of the display may have been lost. The maximum number of characters that can be copied is approximately 65,535 bytes. Retry the copy when the current display contains less information. You can reduce the quantity of information displayed by using the Fields and Select dialogs. ═══ Configuration Error Help ═══ The FAST, Normal, and Slow Gather Frequencies are only available if the CPU Monitor Plus device driver has been installed. Refer to the CPU Monitor Plus User's Guide for information on installing CPU Monitor Plus. ═══ Configuration Error Help ═══ At installation time, CPU Monitor Plus tries to find an installed fixed pitch Courier or System Monospaced font to match your screen resolution. This error message indicates that CPU Monitor Plus was unable to find any matching font for your screen resolution. Check to be sure that you have OS/2 Courier and System Monospaced fonts to match your screen resolution. ═══ 11. Command Line Switches ═══ The following command line switches are available: o /START= o /LOG= o /FREQUENCY= For /START, is the name of a file containing the program names to be started. For /LOG, is the name of the file where logging information will be written. For /FREQUENCY, is the number of seconds (1 to 60) between screen updates. Note: No spaces are allowed between the equals sign ('=') and the value in a command line switch. Spaces are required between each command line parameter. Example: CPUMONP /FREQUENCY=5 /LOG=C:\mylog.log /START=C:\bastart.ba will do the following: o Sets the initial display frequency to 5 seconds; o Enables file logging to the file C:\MYLOG.LOG; o Starts the programs as specified in the file C:\START.BA. Once CPU Monitor Plus is running, data logging may be changed by selecting the Log menu item; Additional programs may be started via the Start menu item; The display frequency may be changed via the Configure menu item. See the CPU Monitor Plus User's Guide for more details on using the command line switches.